home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
doors_2
/
scram_38.zip
/
SCRAMBLE.DOC
< prev
next >
Wrap
Text File
|
1993-05-15
|
15KB
|
393 lines
============================
S C R A M B L E !
============================
COPYRIGHT 1990,93 T&J SOFTWARE
One of the T&J Software Collection of multi-BBS door programs.
Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
UltraBBS, Telegard, TriBBS, Remote Access, WWIV, and
VERSION 3.8 5/15/93
By
Tom Wildoner
397 West Broadway
Jim Thorpe, PA
18229
VOICE (717)325-9480
From
The T&J BBS
(717)325-9481
12/24/9600/14400
LEGALITIES:
===========
THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
OR BREACH OF ANY WARRANTY.
SUPPORT:
========
Please feel free to call me at my BBS number or voice number. Word
lists will be available on my BBS for download as they are prepared.
DISTRIBUTION:
=============
You may make this file available for downloading from your BBS or you may
upload it to any BBS of your choice, provided that you do not make any
changes to the contents of the archive (ZIP file). The archive and its
individual contents may not be used by any service that charges any money
whatsoever, without the written permission of the author.
REGISTERING:
============
Scramble will only use the first 25 words from the list of over
30,000 words until registered.
Once registered -- it will unlock all the features of the registered
version including the full 30,000+ word lists!
FEATURES:
=========
--- Return to BBS on dropped carrier.
--- 4-minutes no activity will return to BBS.
--- Online Chat.
--- You can blank the display.
--- Dump user back to BBS.
--- Drop to DOS function.
--- Desqview Aware.
--- COM0-15 support and non-standard IRQ's.
--- Colorful ANSI screens.
--- Makes TOP TEN ANSI & ASCII bulletins.
--- NO BRUN module needed for play.
--- BETA tested on five different boards.
--- Use of HOT KEYS while in the door.
--- Support BBS available.
--- Easily RESET the entire program.
--- Self maintaining no maintenance required.
--- Door resets every month to give ALL players a chance.
--- Fossil driver support.
INSTALLATION: IMPORTANT!!!!!!!
==================================
Run Scramble using the command line UTILITY.
Example: SCRAM UTILITY
Then, reset the door from scratch. You can also easily setup your
configuration files this way!
UPGRADING:
==========
If you are running a version prior to v3.8 of the door, you'll have to
reinstall the entire door from scratch (including the SYSOP.CFG). Too
many changes were made for an "easy" upgrade.
CONFIGURATION:
=============
Example configuration file for PCBOARD.SYS
------------------------------------------
C:\PCB\PCBOARD.SYS <=- (Full pathname of your PCBOARD.SYS file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for USERS.SYS
----------------------------------------
C:\PCB\USERS.SYS <=- (Full pathname of your USERS.SYS file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for DOOR.SYS
---------------------------------------
C:\BBS\DOOR.SYS <=- (Full pathname of your DOOR.SYS file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for USERINFO.DAT
-------------------------------------------
C:\BBS\USERINFO.DAT <=- (Full pathname of your USERINFO.DAT file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
Example configuration file for CALLINFO.BBS
-------------------------------------------
C:\BBS\CALLINFO.BBS <=- (Full pathname of your CALLINFO.BBS file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for DORINFOx.DEF
-------------------------------------------
C:\BBS\DORINFOx.DEF <=- (Full pathname of your DORINFOx.DEF file
where 'x' is the BBS Node number.
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for SFDOORS.DAT
------------------------------------------
C:\BBS\SFDOORS.DAT <=- (Full pathname of your SFDOORS.DAT file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for CHAIN.TXT
----------------------------------------
C:\BBS\CHAIN.TXT <=- (Full pathname of your CHAIN.TXT file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
Example configuration file for GTUSER.BBS
-----------------------------------------
C:\BBS\GTUSER.BBS <=- (Full pathname of your GTUSER.BBS file)
T&J Software <=- (Change this to your BBS name)
Tom <=- (The Sysop's first name)
Wildoner <=- (The Sysop's last name)
1 <=- (COM port number - defaults to 1)
1 <=- (Node number - defaults to 1)
Example Batch File
==================
A sample batch file is included and is similer to the following:
ECHO OFF
CD\DOORS\SCRAM <=- Switch to the door's Directory.
SCRAM SCRAM.CFG <=- Execute the door program and pass the
configuration filename to the program.
CD\PCB <=- Go back to PCB DIR when user exits door.
BOARD <=- Restart BBS.
This Door is multi-node compatible so you may run more than 1 node from
the same .CFG file provided the path to your system file (DORINFOx.DEF,
CALLINFO.BBS, etc) is exactly the same unless you are using environment
variables, (q.v.)
Environment Variables
=====================
PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
variables. Non-PCBoard systems may also use these variables by including
the following in either your BBS batch or AUTOEXEC.BAT
SET PCBDRIVE=C: <- Drive letter of your BBS files
SET PCBDIR=\BBSDIR <- Path to your BBS files
Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
.CFG file for multi-node operation!
To specify a non-standard IRQ, put the IRQ number after the .CFG on the
command line. For example:
SCRAM SCRAM.CFG /5
or using the PCBDRIVE procedure: SET IRQ=5 and use
SCRAM SCRAM.CFG /%IRQ%
This tells the program to use IRQ 5 instead of the standard IRQ.
Had reports of conflicts when using non-standard IRQ's on Novell/Netware
systems. Seems Novell also uses the / character so something went screwy
somewhere. So I added the * (asterisk) which may be used instead of the /
in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
and are interchangeable.
When specifying the location of the system file on line 1 of the doors .CFG
file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
and %wcnodeid%. Some examples:
PCBoard:
USERS.SYS in C:\PCB - %pcbdrive%%pcbdir%\USERS.SYS
USERS.SYS in C:\PCB\NODE1 - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
Wildcat!:
USERINFO.DAT in C:\WC\NODE1 - C:\WC\NODE%wcnodeid%
Non-PCBoard systems may use the PCB environment variables by setting them
in either AUTOEXEC.BAT or in the batch that runs the door. For example:
SET PCBDRIVE=C:
SET PCBDIR=\BBSDIR
SET PCBNODE=1
Fossil Driver Support
---------------------
DoorFrame supports the use of Fossil drivers. To tell your Door to use the
Fossil driver instead of the standard COM ports, just put /FD on the command
line when running the door. For example:
MYDOOR MYDOOR.CFG /FD
indicates that a Fossil driver is present and should be used. If no Fossil
driver is detected, DoorFrame will print a message to that effect and exit
the door gracefully.
Sysop Keys
==========
F3 - Toggles the printer On/Off. Value is passed to PCBoard and/or
written to DOOR.SYS and USERS.SYS
F4 - Toggles the Page Bell on/off. Value is passed to PCBoard
and/or written to DOOR.SYS and USERS.SYS
F5 - DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
F7 - Toggles the Caller Alarm On/Off. Value is passed to PCBoard
and/or written to DOOR.SYS and USERS.SYS
F8 - Returns the caller involuntarily to the BBS.
F9 - Toggles the local display On/Off. Value is passed to PCBoard
and/or written to DOOR.SYS and USERS.SYS
F10 - Activates SysOp CHAT mode within the DOOR.
ESC - Deactivates CHAT mode. DOOR is resumed.
UP - Give the caller extra time while in the DOOR.
DN - Subtract time from the caller while in the DOOR.
HOME - HELP key for Status Line options.
ALT-N - SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
ALT-X - PCBoard will exit after current caller logs off. Value is
passed to PCBoard. Not available on non-PCBoard systems.
YOUR CONFIGURATION FILE:
========================
Change the SYSOP.CFG file to meet your needs:
20
5
N
C:\BULL.BBS
C:\BULL.BBS
Y
4
LINE 1: Number of words/play a user may attempt.
LINE 2: Current month. Used for resetting the scores monthly!
LINE 3: Tournament mode (Y or N)
LINE 4: Path to your color bulletin.
LINE 5: Path to your ASCII bulletin.
LINE 6: Do you want bulletins created? Y or N
LINE 7: How many times a player may enter the door per day.
TOURNAMENT MODE:
================
Turning tournament mode on does the following: The first player of the
day will have to wait a few seconds until the tournament words are
selected. Next, the tournament words will be compiled into a file
called TOURNY.TXT. All users who play today will get the same words
(scrambled differently).
LOCAL MODE:
===========
To run in LOCAL mode simply run SCRAMBLE using the LOCAL command line:
Example: SCRAM LOCAL
RESETTING:
==========
Scramble will reset at the first of each month -- no maintenance
needed. However, you can reset Scramble any time you wish using the
UTILITY command string and then selecting the appropriate menu
item.
WORD LISTS:
===========
Word lists are now history, we've compiled the words into one large
database of words. This has dramatically increased the speed of the
door!
FUTURE VERSIONS:
================
---> What would you like to see added? Just let me know.
VERSION HISTORY:
================
Version 1.00 ......... First release. 2/2/91
Version 1.10 ......... Maintenance update. Changed BBS name. 8/17/91
Version 2.00 ......... Now using BASIC PDS v7.1, all external files
placed inside the main code, now support WC!
2.x and 3.x, added tournament mode. 10/1/91
Version 2.10 ......... Fix for BBS running with com port unlocked.
Other small mods made also. 02/01/92
Version 3.00 ......... Converted to DoorFrame routines -- facelift
for the program. 02/23/92
Version 3.10 ......... Recompiled using newer DoorFrame routines and
added new bulletin routines. 04-17-1992
Version 3.50 ......... Cleaned the code a little, added the ability
to view the TOP TEN while in the door, got
rid of the SEXTRA program, made a new RESET
program, moved tournament routines inside the
main code. 05-16-92
Version 3.60 ......... Verify and Setup have been moved into the main
code. Door updated with the newest door routines.
05-24-92
Version 3.60 ......... Fixed small problem with Scramble not resetting
the scores monthly. 06-06-92
Version 3.70 ......... Basically re-wrote the entire door. Got rid of
some menacing screens. Added 'V' at the main
menu to view the scores. Added almost 30,000
words to the door. Now supports fossil drivers
and IRQ number larger than one
digit. Got rid of the BONUS CATAGORY listing
and decided to give bonus points just on word
length. Added a new timer function that will
give 20 seconds plus however many letters there
are in the word. Added better support for
boards running in a network environment and
also now supports the short version of
DOOR.SYS. The screen now automatically redraws
after a CHAT or DROP to DOS. Got rid of the
VERIFY program to verify word lists. The door
will now run "registered" when playing locally
and allow multiple people to play locally
instead of just the sysop. 12-04-1992
Version 3.80 ......... Got rid of all the seperate word lists and
compiled to words into one large database,
added support for COM0-15, added support for
more than one play per day, bulletins are
now optional, speeded up the code a little.
05-15-1993
That's all there is to it! If you have any problems or questions
please feel free to call the T&J BBS at (717)325-9481.
Future add on word lists will be available to DL from my BBS.
See the REGISTER.TXT file for registering.
Your users will get a lot of duplicate words until the game is
registered.